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Foreword 



id , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part of the 32.32x-series covering the 3rd Generation Partnership Project; Technical 
Specification Group Services and System Aspects; Telecommunication Management; Test management Integration 
Reference Point (IRP), as identified below: 



32.321 
32.322 
32.323 

32.324 



"Requirements"; 
"Information service"; 
"CORBA solution set"; 

"CMIP solution set". 



The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document specifies the CORBA Solution Set (SS) for the IRP whose semantics is specified in Test 
Management IRP: Information Service (IS) (3GPP TS 32.322 [6]). 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. 
Clause 5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. 
Clause 6 describes the notification interface containing the push method. Annex A contains the IDL specification. 

This Solution Set specification is related to 3GPP TS 32.322 (V5.0.X). 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] Object Management Group 98 (November 1998): "Notification Service: Joint Revised Submission 

OMG TC Document telecom/98- 1 1-01" . http://www.omg.org/technology/documents/ 

[2] OMG CORBA Services (November 1996): "Common Object Services Specification" (clause 4 

contains the Event Service specification), http://www.omg.org/technology/documents/ 

[3] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management; Notification 

Integration Reference Point; Information Service version 1". 

[5] 3GPP TS 32.303: "Telecommunication management; Configuration Management; Notification 

Integration Reference Point; CORBA solution set version 1:1". 

[6] 3GPP TS 32.322: "Telecommunication management; Test management Integration Reference 

Point (IRP); Information service". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information service". 

[8] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions defined in 3GPP TS 32.322 [6] apply. There are no 
additional definitions applicable to the present document. 
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3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

IOC Information Object Class 

IS Information Service 

NE Network Element 

OMG Object Management Group 

QoS Quality of Service 

SS Solution Set 

3.3 IRP document version number string 

The IRP document version number (sometimes called "IRP version" or "version number") string is used to identify the 
present document. The definition of "IRP document version number string" in 3GPP TS 32.31 1 [8] provides the rule to 
derive such a string. 

This string is returned in get_test_management_IRP_versions method and is carried in the first field of the 
notification header of all notifications related to Test Management IRP. This string is also returned in 
get_notif ication_categories method of the Notification IRP Agent, in case that IRP Agent is responsible for 
emitting notifications related to Test Management IRP. 



4 Architectural features 

The overall architectural feature of Test Management IRP is specified in 3GPP TS 32.322 [6]. The present document 
specifies features that are specific to the CORBA SS. 

4.1 Notification Services 

In implementations of CORBA SS, IRP Agent conveys Test Management information to IRPManager via OMG 
Notification Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality of Service (QoS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
TestManagementlRPNotif ications notifications as specified in 3GPP TS 32.322 [6]. 



4.2 Push and Pull Style 



OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This Notification CORBA SS [5] specifies that support of Push style is Mandatory (M) and that support of Pull style is 
Optional (O). 
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4.3 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 
notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 
are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, IRP Agent 
shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, IRP Agent shall 
invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started after each push 
invocation. 



5 Mapping 

5.1 Operation and Notification mapping 

Test Management IRP: IS 3GPP TS 32.322 [6] defines semantics of operation and notification visible across the Test 
Management IRP. Table 1 indicates mapping of these operations and notifications to their equivalents defined in this 
SS. 

Table 1 : Mapping from IS Operations and Notification to SS equivalents 



IS Operations/ notification TS 32.322 [6] 


SS Method 


Qualifier 


initiateTests 


initiate tests 


M 


terminateTests 


terminate tests 


M 


monitorTest 


monitor test 


M 


getlRPVersion 


get test management IRP versions 


M 


getOperationProfile (see note) 


get test management IRP operation profile 





getNotificationProfile (see note) 


get test management IRP notification profile 





notify TestResu It 


push structured event (See subclause 6.1) 


M 


NOTE: This operation is of ManagedGenericIRP IOC specified in 3GPP TS 32.312 [7]. The TestManagementIRP 
IOC of [6] inherits from it. 



5.2 Operation parameter mapping 



The Test Management IRP: IS 3GPP TS 32.322 [6] defines semantics of parameters carried in operations across the 
Test Management IRP. The following tables indicate the mapping of these parameters, as per operation, to their 
equivalents defined in this SS. 

Table 2: Mapping from IS initiateTests parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


testlnvocationlnitiator 


TestManagementlRPConstDefs: Testlnvocationlnitiator 
test invocation initiator 


M 


maxTestingStateDuration 


long maxtestingStateDuration 


M 


toBelnitiatedTests 


TestManagementlRPConstDefs::ToBelnitiatedTestSeq 
to be initiated test seq 


M 


response 


TestManagementlRPConstDefs::lnitiateTestsResponse 

Exceptions: 
InitiateTests, 

ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 3: Mapping from IS terminateTests parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


toBeTerminatedTests 


TestManagementlRPConstDefs::ToBeTerminatedTestSeq 
to be terminated test seq 


M 


response 


TestManagementlRPConstDefs::TerminateTestsResponse 

Exceptions: 

TerminateTests, 

ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 4: Mapping from IS monitorTest parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


toBeMonitoredTO 


TestManagementlRPConstDefs::ToBeMonitoredTO 
to be monitored TO 


M 


attributeList 


TestManagementlRPConstDefs::TOAttributeListtO attribute list 


M 


error 


ManagedGenericlRPConstDefs::Signal 

Exceptions: 
MonitorTest, 

ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 
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5.3 Notification parameter mapping 



The Test Management IRP: IS 3GPP TS 32.322 [6] defines semantics of parameters carried in notifications. The 
following table indicates the mapping of these parameters to their OMG CORBA Structured Event (defined in OMG 
Notification Service [1]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification 
Service [1], is: 



Header 



3ody 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f i Iter able_body_fie Ids 
remaining_body 



The following table lists all OMG Structured Event attributes in the second column. The first column identifies the Test 
Management: IS 3GPP TS 32.322 [6] defined notification parameters. 

Table 5: Mapping for notifyTestResuit 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


There is no corresponding 
IS attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.3. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


Type_name 


M 


This is the NOTIFY_TM_TEST_RESULT of module of 
TestManagementlRPConstDefs. 


There is no corresponding 
IS attribute 


event_name 


M 


It carries no information. 


There is no corresponding 
IS attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 

filterable_ 

body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
Notification 1 RPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS [5]. 


notificationld 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification 
IRP: CORBA SS [5]. 


eventTime 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


systemDN 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the SYSTEM_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS [5]. 


testlnvocationlnitiator 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the TESTJNVOCATIONJNITIATOR of 
module TestManagementlRPConstDefs. 

Value of NV pair is a string. 


testlnvocationld 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the TESTJNVOCATIONJD of module 
TestManagementlRPConstDefs. 

Value of NV pair is a string. 
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IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


testActualStartTime 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is the TEST_ACTUAL_START_TIME of module 
TestManagementlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


testActualStopTime 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is the TEST_ACTUAL_STOP_TIME of module 
TestManagementlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


testOutcome 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is the TEST_OUTCOME of module 
TestManagementlRPConstDefs. 

Value of NV pair is the enum TestOutcomeType of 
TestManagementlRPConstDefs. 


mORT 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is the MORT of module 
TestManagementlRPConstDefs. 

Value of NV pair is a string. 


proposedRepairActions 


One NV pair of 

filterable_body_f 

ields 





Name of NV pair is the PROPOSED_REPAIR_ACTIONS of 
module TestManagementlRPConstDefs. 

Value of NV pair is a string. 


additionallnformation 


Two NV pair of 

filterable_ 

body_fields 





Name of one NV pair is the TEST_ADDITIONAL_INFORMATION 
of module TestManagementlRPConstDefs. 

Value of NV pair is a string. 


fileReference 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is FILE_REFERENCE of module 
TestManagementlRPConstDefs. 

Value of NV pair is a string. 


fileExpiryDate 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is the FILE_EXPIRY_DATE of module 
TestManagementlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


There is no corresponding 
IS attribute. 


remaining_body 
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6 TestManagementlRPNotification Interface 

OMG CORBA Notification push operation is used to realise the notification of 

TestManagementlRPNotif ications. All the notifications in this interface are implemented using this 
push_structured_event method. 



6.1 Method push (M) 



module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises { CosEventComm: :Disconnected) ; 

} ; // SequencePushConsumer 

}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [1]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

"TestManagementlRPConstDefs.idl") 

#ifndef TestManagementlRPConstDef s_idl 
#def ine TestManagementlRPConstDef s_idl 

#include "CosNotif ication. idl" 

#include "ManagedGenericIRPConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: TestManagement IRPConstDef s 

This module contains commonly used definitions for Test Management IRP 

*/ 

module TestManagementlRPConstDef s 
{ 

/* 

This defines the notification type of this Test Management 
IRP. 

*/ 

const string NOTIFY_TM_TEST_RESULT = "xl"; 

/* 

This enum defines the test state 

*/ 

enum TestStateType { 

Notlnitialized, 

Idle, 

Initializing, 

Testing, 

Terminating, 

Disabled 
}; 

/* 

This enum defines the test outcome 

*/ 

enum TestOutcomeType { 

Inconclusive, 

Pass, 

Fail, 

TimeOut, 

PrematureTermination 



/* 

This block defines notification attributes of this IRP. 
These attribute values should not clash with those used 
in Notification header (see IDL of Notification IRP) 
*/ 

const string TEST_INVOCATION_INITIATOR = "f"; 
const string TEST_INVOCATION_ID = "g"; 
const string TEST_ACTUAL_START_TIME = "h"; 
const string TEST_ACTUAL_STOP_TIME = "i"; 
const string TEST_0UTC0ME = "j"; 
const string MORT = "k"; 

const string PROPOSED_REPAIR_ACTIONS = "1"; 
const string ADDITIONAL_INFORMATION = "m"; 
const string FILE_REFERENCE = "n"; 
const string FILE_EXPIRY_DATE = "o"; 
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typedef string Testlnvocationlnitiator; 
typedef string ToBeMonitoredTO; 

typedef CosNotif ication: :PropertySeq NVPairs; 

/* 

Define a seq of to-be-initiated-test 

*/ 

struct ToBelnitiatedTest 

{ 

unsigned long max_testing_state_duration; //seconds; 0->no limit 

string toBeTestedMORT; //MORT DN 

string vSTOC; //MORT class 

NVPairs vSTONVPair; //MORT attributes in NV pairs 

}; 

typedef sequence <ToBeInitiatedTest> ToBelnitiatedTestSeq; 

/* 

Define the structure returned by initiate_tests 

*/ 

struct InitiateTestsResponseElement 

{ 

// If f ailureReason is NULL, the test is initiated successfully and 

// test Invocationld contains the invocation id. 

// Else, the test initiation fails and f ailureReason contains 

// the failure reason and testlnvocationld contains garbage. 

string f ailureReason; 

string testlnvocationld; 

}; 

typedef sequence <InitiateTestsResponseElement> InitiateTestsResponse; 



/* 

Define a seq of to-be-terminated-test 

*/ 

typedef string Testlnvocationld; 

typedef sequence <TestInvocationId> ToBeTerminatedTestSeq; 

/* 

Define the structure returned by terminate_tests 

*/ 

struct TerminateTestsResponseElement 

{ 

// If f ailureReason is NULL, the test has terminated successfully and 
// testlnvocationld identifies the terminated invocation. 
// Else, the test termination fails and f ailureReason contains 
// the failure reason and testlnvocationld contains garbage, 
string f ailureReason; 
string testlnvocationld; 

}; 

typedef sequence <TerminateTestsResponseElement> TerminateTestsResponse; 

/* 

Define the structure of a TOAttributes . 

*/ 

struct TOAttributes 

{ 

TestStateType teststate; 

TestOutcomeType testOutcome; 

NVPairs attributesInNVPairs; 



#endif 
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A.2 IDL specification (file name 

"TestManagementlRPSystem.icH") 

tifndef TestManagementIRPSystem_idl 
#def ine TestManagement IRPSystem_idl 

#include "TestManagementlRPConstDef s . idl" 
#include "ManagedGenericIRPSystem. idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: TestManagementlRPSystem 

This module contains the specification of all methods of TestManagement IRP Agent. 



*/ 

module TestManagementlRPSystem 
{ 

/* 

System may fail to complete an operation. System can provide reason 

to qualify the failed reason. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception GetTestManagementlRPVersions { string reason; }; 

exception GetTestManagementlRPOperationsProf ile { string reason; }; 

exception GetTestManagementlRPNotif icationProf ile { string reason; }; 

exception InitiateTests { string reason; }; 

exception TerminateTests { string reason; }; 

exception MonitorTest { string reason; }; 



interface TestManagementIRP 
{ 

/* 

Return the list of all supported TestManagement IRP versions. 

*/ 

ManagedGenericIRPConstDef s : : Vers ionNumber Set 

get_Test_Management_IRP_versions ( 



raises (GetTestManagementlRPVersions) ; 



/* 

Return the list of all supported operations and their supported 

parameters for a specific TestManagement IRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_Test_Management_IRP_operations_prof ile { 

in ManagedGenericIRPConstDef s : : VersionNumber 
test_management_irp_version 

) 

raises {Get Test Management IRPOpe rationsP r of ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Return the list of all supported notifications and their supported 

parameters for a specific TestManagement IRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_Test_Management_IRP_notif ication_prof ile ( 
in ManagedGenericIRPConstDef s : : VersionNumber 
test__management_irp__version 

) 

raises {GetTestManagementlRPNotif icationProf ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 



/* 

Request to initiate tests. 

*/ 

TestManagement IRPConstDefs : : InitiateTestsResponse 

initiate_tests { 
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in TestManagementlRPConstDef s : : Testlnvocationlnitiator 

test_invocation_initiator, 
in TestManagementlRPConstDef s : : ToBelnitiatedTestSeq 
to_be_initiated_test_seq 
) 
raises (InitiateTests, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to terminate tests. 

*/ 

TestManagementlRPConstDef s : : TerminateTestsResponse 

terminate_tests ( 

in TestManagementlRPConstDef s : : ToBeTerminatedTestSeq 
to_be_terminated_test_seq 
) 
raises (TerminateTests, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request test info (to monitor a test) . 
*/ 

ManagedGenericIRPConstDef s :: Signal monitor_test ( 
in TestManagementlRPConstDef s : : ToBeMonitoredTO 

to_be_monitored_TO, 
out TestManagementlRPConstDefs : : TOAttributes tO_attributes 
) 
raises (MonitorTest, 

ManagedGenericIRPSystem: : InvalidParameter) ; 



}; 

#endif 
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